Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

New resource: aws_ami_description - lookup AMI via DescribeImages #4396

Closed

Conversation

vancluever
Copy link
Contributor

I made this resource because I wanted an easy way to look up the latest AWS NAT images. Of course, with the advent of the new NAT gateway and the respective resource in Terraform (which I just found out about today!), this is a bit moot, but I'm hoping this will find other use cases. I myself will be using this to simplify some of my build pipelines that require a pre-built instance, produced by things like packer.

Check it out, any questions or comments let me know. Docs are included in this PR, of course. Tests cover looking up a NAT instance, a Windows instance, and a Ubuntu instance store instance.

@antonbabenko
Copy link
Contributor

👍 for this kind of resource, but I have some suggestions. I think aws_ami_find is better name, also argument references should be more like in Ansible ec2_ami_find module (http://docs.ansible.com/ansible/ec2_ami_find_module.html) and compatible with existing ami resource (https://www.terraform.io/docs/providers/aws/r/ami.html). More specifically, virtualization_type, architecture, name, ami_tags, is_public, owner, region, no_result_action.

@vancluever
Copy link
Contributor Author

@antonbabenko, sorry but I disagree. The name is fine, I don't see the need to change it, same with the parameters. In fact both the resource name and filter parameter are modelled after the API call it consumes.

To address the issue of why not have more finer grained parameters:

  • filter parameters can be used with most if not all of the flags above, and multiples are allowed. The submitted docs refer the reader to the CLI docs where they can get a full reference of allowed filter keys - this also ensures that any changes/updates to these keys do not require an update the the source. The only one that I see missing is region but I think that is because Ansible needs to make the EC2 connection when it's configuring the resource, while Terraform handles this on the provider level. It is not a filter parameter.
  • aws_ami uses a different API call that requires a lot of the parameters mentioned. Further, aws_ami creates images, and does not search for them.
  • A conscious decision was made to fail if the result was <> 1 because the intention here is to ensure that a a single AMI is pulled per definition, allowing one to rely on the result that is returned. no_result_action is unnecessary here as we already know what the action will be if there is no result, and that is to fail. Again the docs say as much.

@mtb-xt
Copy link

mtb-xt commented Dec 20, 2015

👍 This would really make life easier for me!

@apparentlymart
Copy link
Contributor

Thanks for this, @vancluever.

Over in #4169 we have been discussing a new concept for fetching data in Terraform, with finding AMIs being one example use-case. That would allow this result to be achieved in a more predictable way.

That idea is still under discussion, so not necessarily a reason to block progress on this simpler change but note that the existing limitations with read-only resources described in that issue would apply to this AMI resource too.

@vancluever
Copy link
Contributor Author

Thanks @apparentlymart, I have some thoughts I'll post over there too, also I'd love for this to be a pilot for that! I'm not too sure how far out it is, but once it's hashed out I'd be more than happy to do the work to make this a data source.

In the meantime if there's anything else needed to get this merged let me know.

@vancluever
Copy link
Contributor Author

Updated the PR with the executable_users and owners parameters, this allows further filtering based on API/SDK parameters and more usefully allows one to search on their own images (using the self keyword).

executable_users is a little tough to test as the test will fail if you don't have any images, and otherwise you are searching on arbitrary account IDs. I did have a test in for it before pushing, but it was failing due to no results, so at least it's working!

Also made a few corrections to the docs (filter values were not lists when they should have been).

@vancluever vancluever force-pushed the paybyphone_aws_ami_description branch from 06440fc to 4abb361 Compare December 23, 2015 04:05
@vancluever
Copy link
Contributor Author

Another update - ensure a missing Ebs section of BlockDeviceMappings is handled gracefully, and also a minor correction to the docs.

@ketzacoatl
Copy link
Contributor

I would be interested to know - is there anything blocking this PR as it stands?

@vancluever
Copy link
Contributor Author

Hey @ketzacoatl yeah I'm not too sure. Could be the HashiCorp folks are just backed up on other stuff.

But yeah guys if there's anything that needs that is holding it up let me know. I have been using this in production now with some pretty good results and it's a part of one of my pipelines now, and soon to be part of a second.

@mtb-xt
Copy link

mtb-xt commented Feb 22, 2016

Can this be merged? Maybe @phinze , please?

@vancluever vancluever force-pushed the paybyphone_aws_ami_description branch from 4abb361 to e603843 Compare April 7, 2016 20:02
@vancluever
Copy link
Contributor Author

Everyone - it's been a while since this PR is in, and I'm still using it, so I figured I'd give it a rebase to make it easier to merge.

Would love to see this in upstream - even it it gets removed in 0.7 (and again, I would be totally fine with porting it over to a data source when that happens).

@vancluever vancluever force-pushed the paybyphone_aws_ami_description branch 2 times, most recently from 1195457 to 24a0e31 Compare April 20, 2016 17:02
@vancluever vancluever closed this Apr 20, 2016
@vancluever vancluever deleted the paybyphone_aws_ami_description branch April 20, 2016 17:44
@vancluever vancluever restored the paybyphone_aws_ami_description branch April 20, 2016 17:44
@apparentlymart
Copy link
Contributor

@vancluever I was planning to use aws_ami as a first data source to spin the wheels of that feature a bit and develop some general patterns for mapping AWS Describe* functions to data sources... my intent was to take the guts of your implementation here and use it as my starting point, if that's okay with you...

In which case, I expect we'd merge the data source equivalent of this as part of the data source work, as an end-to-end proof that it's working.

@vancluever
Copy link
Contributor Author

vancluever commented Apr 20, 2016

Hey @apparentlymart, I was just typing a message! lol.

I actually fat-fingered the delete button on this branch while doing some cleanup on our fork. Is there any way to restore the status on this PR? Whatever works. :)

@apparentlymart
Copy link
Contributor

I'll reopen it for now and if I do end up merging something equivalent to this in the data sources work I'll come back and update it.

@vancluever
Copy link
Contributor Author

vancluever commented Apr 20, 2016

Thanks @apparentlymart! And yeah, it's my hope that the work here and in #4848 would find its way into #4961. Cheers!

@vancluever vancluever force-pushed the paybyphone_aws_ami_description branch from c1f3baa to 9a7b289 Compare May 16, 2016 20:34
@vancluever
Copy link
Contributor Author

Hey @apparentlymart, just wondering if you started work on this as a data source yet? If not, I can get it done.

@apparentlymart
Copy link
Contributor

@vancluever I have not worked directly on this yet but in #6819 I have a general utility ec2_filters.go that does a bunch of the work for these EC2-related data sources... you might want to use that in your work here.

I also have these notes on the design methodology I was following for these, in ther hope of keeping them relatively consistent with each other: https://gist.github.com/apparentlymart/e62c81db609eca1fe08dc8226dd48485

@vancluever
Copy link
Contributor Author

@apparentlymart roger, I'll start work on it then! I'll take a look at that, sounds like based on name alone there might be some helpers there that I had to write for this as well, so I'll make sure to re-factor to use those.

@vancluever vancluever mentioned this pull request May 25, 2016
vancluever pushed a commit to paybyphone/terraform that referenced this pull request May 28, 2016
This data source allows one to look up the most recent AMI for a specific
set of parameters, much like aws ec2 describe-images in the AWS CLI.

Basically a refresh of hashicorp#4396, in data source form.
vancluever pushed a commit to paybyphone/terraform that referenced this pull request May 28, 2016
This data source allows one to look up the most recent AMI for a specific
set of parameters, much like aws ec2 describe-images in the AWS CLI.

Basically a refresh of hashicorp#4396, in data source form.
vancluever pushed a commit to paybyphone/terraform that referenced this pull request May 28, 2016
This data source allows one to look up the most recent AMI for a specific
set of parameters, much like aws ec2 describe-images in the AWS CLI.

Basically a refresh of hashicorp#4396, in data source form.
vancluever pushed a commit to paybyphone/terraform that referenced this pull request May 29, 2016
This data source allows one to look up the most recent AMI for a specific
set of parameters, much like aws ec2 describe-images in the AWS CLI.

Basically a refresh of hashicorp#4396, in data source form.
@vancluever
Copy link
Contributor Author

Now that #6911 is merged, closing this one off as we now have this in data source form with aws_ami!

@vancluever vancluever closed this May 29, 2016
@vancluever vancluever deleted the paybyphone_aws_ami_description branch May 30, 2016 01:47
grubernaut pushed a commit to hashicorp/terraform-provider-aws that referenced this pull request Jun 9, 2017
This data source allows one to look up the most recent AMI for a specific
set of parameters, much like aws ec2 describe-images in the AWS CLI.

Basically a refresh of hashicorp/terraform#4396, in data source form.
@ghost
Copy link

ghost commented Apr 25, 2020

I'm going to lock this issue because it has been closed for 30 days ⏳. This helps our maintainers find and focus on the active issues.

If you have found a problem that seems similar to this, please open a new issue and complete the issue template so we can capture all the details necessary to investigate further.

@ghost ghost locked and limited conversation to collaborators Apr 25, 2020
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants